home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 012 / newkey24.arc / DEMO.KEY < prev    next >
Text File  |  1985-06-26  |  29KB  |  425 lines
  1. <begdef><altF1>cls<enter>
  2.                   A GUIDED TOUR OF NEWKEY                               <ESC>
  3.                                                                         <ESC>
  4. (C)Copyright Frank Bell, 1984                                           <ESC>
  5. All rights reserved.                                                    <ESC>
  6.                                                                         <ESC>
  7.      Newkey is a product of                                             <ESC>
  8.                                                                         <ESC>
  9.                   FAB Software                                          <ESC>
  10.                   P.O. Box 336                                          <ESC>
  11.                   Wayland, MA 01778                                     <ESC>
  12.                                                                         <ESC>
  13.      If you have not already, please print the enclosed documentation   <ESC>
  14. by issuing the command 'printdoc'.  This will print the documentation   <ESC>
  15. on your printer.                                                        <ESC>
  16.                                                                         <ESC>
  17.      This tour is intended to serve as a general introduction to        <ESC>
  18. Newkey.  In not intended to replace or supplement the printed user's    <ESC>
  19. manual (50+ pages, comes with registration).                            <ESC>
  20.                                                                         <ESC>
  21.     This tour may be exited at any time by pressing CTRL F3.            <ESC>
  22.                                                                         <ESC>
  23.     Press ALT H for help.                                               <ESC>
  24.                                                                         <ESC>
  25.     Press ALT F2 to continue.                                           <ESC>
  26. <enddef>
  27. *
  28. <begdef><altf2>cls<enter>
  29.                         SCREEN SAVER WARNING                            <ESC>
  30.                                                                         <ESC>
  31.     Before you get started, just one note of warning.  Newkey contains  <ESC>
  32. a screen saver feature that turns off your display after 2 minutes of   <ESC>
  33. inactivity.  This is designed to prevent the phosphors from permanently <ESC>
  34. etching an unattended display.                                          <ESC>
  35.                                                                         <ESC>
  36.     If the screen should suddenly go blank, don't worry.  Just press    <ESC>
  37. any key and the screen will be turned back on.                          <ESC>
  38.                                                                         <ESC>
  39.     This is just one of the many useful features Newkey offers, and     <ESC>
  40. like most of Newkey's other features can be customized to meet your     <ESC>
  41. wishes.                                                                 <ESC>
  42.                                                                         <ESC>
  43.                                                                         <ESC>
  44.     Press F1 to begin your tour.                                        <ESC>
  45. <enddef>
  46. *
  47. <begdef><F1>cls<enter>     
  48.                      WELCOME TO NEWKEY                                  <ESC>
  49.                                                                         <ESC>
  50.            A POWERFUL MACRO PROCESSOR FOR THE IBM PC                    <ESC>
  51.                                                                         <ESC>
  52.                                                                         <ESC>
  53.      This starts a guided tour which will introduce you to many         <ESC>
  54. of Newkey's powerful features.  We will show you how to take control    <ESC>
  55. of your keyboard and make your software easier to use.                  <ESC>
  56.                                                                         <ESC>
  57.     This tour uses Newkey macros extensively.  In fact every thing you  <ESC>
  58. are reading has been generated from macros.  This tour does not use a   <ESC>
  59. program.  You will be operating under DOS the whole time.               <ESC>
  60.                                                                         <ESC>
  61.                                                                         <ESC>
  62.                            What is a Macro?                             <ESC>
  63.                                                                         <ESC>
  64.      A macro is any sequence of keystrokes which are assigned to a      <ESC>
  65. particular key.  These allow customization of software packages,        <ESC>
  66. keyboard redefinition, creation of boiler plate passages, and other     <ESC>
  67. useful purposes.  Macros will also be called key definitions or         <ESC>
  68. translations in this demonstration.                                     <ESC>
  69.                                                                         <ESC>
  70.     Lets start by defining a macro.  Press F2 to continue.              <ESC>
  71. <enddef>
  72. *
  73. <begdef><F2>cls<enter>
  74.                        DEFINING A MACRO                                 <ESC>
  75.                                                                         <ESC>
  76.                                                                         <ESC>
  77.     To define a macro follow these steps:                               <ESC>
  78.                                                                         <ESC>
  79. 1.  Press the ALT = key.  This will cause the cursor to take on a       <ESC>
  80. block shape.                                                            <ESC>
  81.                                                                         <ESC>
  82. 2.  Press the key you wish to define.                                   <ESC>
  83.                                                                         <ESC>
  84. 3.  Now enter the keystrokes you want the key to represent.             <ESC>
  85.                                                                         <ESC>
  86. 4.  Press ALT = to end the definition.                                  <ESC>
  87.                                                                         <ESC>
  88.     A macro may be defined at anytime, whether in a program or DOS.     <ESC>
  89. Newkey will save your keystrokes and then pass them on.  Your program   <ESC>
  90. will not even know that Newkey exists!                                  <ESC>
  91.                                                                         <ESC> 
  92.     Now lets define a macro consisting of your first name and place     <ESC>
  93. it in ALT N.  Follow the above steps.                                   <ESC>
  94.                                                                         <ESC>
  95.                                                                         <ESC>
  96.     Are you finished?  Press F3 to continue, ALT H for help.            <ESC>
  97. <enddef>
  98. *
  99. <begdef><F3><ESC>cls<enter>
  100.                     NESTED KEY DEFINITIONS                              <ESC>
  101.                                                                         <ESC>
  102.      Hi <altn> !                                              <ESC>
  103.                                                                         <ESC>
  104.      How did I know your name?  This is an example of nested key        <ESC>
  105. definition.  Now that you have placed your name in ALT N, whenever      <ESC>
  106. Newkey finds ALT N in a macro it will return your name instead of ALT N.<ESC>
  107.                                                                         <ESC>
  108.     Nested key definition means that Newkey will check each key in a    <ESC>
  109. to see if it has its own macro assigned to it.  Newkey will check to    <ESC>
  110. a depth of 8 levels.                                                    <ESC>
  111.                                                                         <ESC>
  112.      Nested key definitions are very useful in many instances.  For     <ESC>
  113. example, you can develop a set of macros designed to operate on a file  <ESC>
  114. designated by the ALT F key.                                            <ESC>
  115.                                                                         <ESC>
  116.      Then, when you start a session on your PC, you can define ALT F    <ESC>
  117. equal to the file name you are working on and with 1 keystroke invoke   <ESC>
  118. your editor, bring up the file in edit mode and reset default editor    <ESC>
  119. modes.  1 keystroke might also print the file, copy it from 1 disk to   <ESC>
  120. another, or save it from ram disk to floppy and return to your current  <ESC>
  121. position without leaving your editor.                                   <ESC>
  122.                                                                         <ESC>
  123.      Press F4 to continue, ALT H for help.                              <ESC>
  124. <enddef>
  125. *
  126. <begdef><F4>cls<enter>
  127.                VARIABLE LENGTH FILL-IN-THE-BLANKS                       <ESC>
  128.                   Demonstration for <altn>                          <ESC>
  129.                                                                         <ESC>
  130.      Newkey provides you with the ability to define variable length     <ESC>
  131. fill-in-the-blanks fields within key translations.  When one of these   <ESC>
  132. is encountered in a key translation, Newkey will stop translation and   <ESC>
  133. wait for you to enter any keystrokes you wish.  Newkey will continue    <ESC>
  134. to accept keystrokes until the enter key is pressed when normal         <ESC>
  135. translation will continue.  To define a variable length                 <ESC>
  136. fill-in-the-blanks field follow these steps:                            <ESC>
  137.                                                                         <ESC>
  138.    1.  Press ALT -.  The cursor will change from a full block to half   <ESC>
  139.    block with its bottom missing.                                       <ESC>
  140.                                                                         <ESC>
  141.    2.  Enter whatever keystrokes you wish.                              <ESC>
  142.                                                                         <ESC>
  143.    3.  Press ALT -.  The cursor will change back to a full block.       <ESC>
  144.                                                                         <ESC>
  145.      This is very useful in situations where you need to enclose a      <ESC>
  146. field which varies in length with repetitive text.                      <ESC>
  147.                                                                         <ESC>
  148.      Press ALT 1 for a demonstration of a variable length field.        <ESC>
  149.      Press F5 to continue, ALT H for help.                              <ESC>
  150. <enddef>
  151. *
  152. <begdef><F5><esc>cls<enter>
  153.             FIXED LENGTH FILL-IN-THE-BLANKS                             <ESC>
  154.                Demonstration for <altn>                              <ESC>
  155.                                                                         <ESC>
  156.      Newkey provides you with the ability to define fixed length        <ESC>
  157. fill-in-the-blanks fields within key translations.  When one of these   <ESC>
  158. is encountered in a key translation, Newkey will stop translation and   <ESC>
  159. wait for you to enter a predefined number of keystrokes.  Newkey        <ESC>
  160. will accept keystrokes until the predefined number is reached when      <ESC>
  161. normal translation will continue.  To define a fixed length             <ESC>
  162. fill-in-the-blanks field follow these steps:                            <ESC>
  163.                                                                         <ESC>
  164.    1.  Press ctrl -.  The cursor will change from a full block to half  <ESC>
  165.    block with its top missing.                                          <ESC>
  166.                                                                         <ESC>
  167.    2.  Enter whatever keystrokes you wish.                              <ESC>
  168.                                                                         <ESC>
  169.    3.  Press ctrl -.  The cursor will change back to a full block.      <ESC>
  170.                                                                         <ESC>
  171.      Press ALT 2 for a demonstration of a fixed length field.           <ESC>
  172.      Press F6 to continue, ALT H for help.                              <ESC>
  173. <enddef>
  174. *
  175. <begdef><F6><esc>cls<enter>
  176.             SWITCHING NEWKEY OFF/ON - CTRL 6                            <ESC>
  177.                Demonstration for <altn>                              <ESC>
  178.                                                                         <ESC>
  179.                                                                         <ESC>
  180.                                                                         <ESC>
  181.      Newkey may be deactivated/activated by pressing ctrl 6.  This acts <ESC>
  182. as toggle switching Newkey from one status to another.  When            <ESC>
  183. deactivated Newkey is still resident in memory but it will act as if    <ESC>
  184. the normal keyboard interrupt is in control.                            <ESC>
  185.                                                                         <ESC>
  186.    Press CTRL 6 followed by F6.  Nothing happens.                       <ESC>
  187.                                                                         <ESC>
  188.    Now press CTRL 6 followed by F6 and watch this screen be             <ESC>
  189. redisplayed.                                                            <ESC>
  190.                                                                         <ESC>
  191.    Press F7 to continue, ALT H for help.                                <ESC>
  192.                                                                         <ESC>
  193. <enddef>
  194. *
  195. <begdef><F7><esc>cls<enter>
  196.               TRANSLATION BYPASS - CTRL 2                               <ESC>
  197.                Demonstration for <altn>                              <ESC>
  198.                                                                         <ESC>
  199.                                                                         <ESC>
  200.                                                                         <ESC> 
  201.     Key translation may be bypassed by pressing CTRL 2 followed by the  <ESC>
  202. key desired.  This has the same effect as switching Newkey off, except  <ESC>
  203. that it lasts for only one keystroke.                                   <ESC>
  204.                                                                         <ESC>
  205.                                                                         <ESC>
  206.    Press ALT 3 for a demonstration of translation bypass.               <ESC>
  207.                                                                         <ESC>
  208.    Press F8 to continue, ALT H for help.                                <ESC>
  209.                                                                         <ESC>
  210. <enddef>
  211. *
  212. <begdef><F8><esc>cls<enter>
  213.               DYNAMIC DISPLAY/UPDATE FEATURES                           <ESC>
  214.                Demonstration for <altn>                              <ESC>
  215.                                                                         <ESC>
  216.      The dynamic display/update features are a subset of Newkeysp       <ESC>
  217. functions which may be invoked at any time by pressing Ctrl \           <ESC>
  218. (backslash) without leaving your current program.  Newkey will save     <ESC>
  219. your current screen, present you with a menu of options and, when you   <ESC>
  220. are done, restore your screen just where you left off.                  <ESC>
  221.                                                                         <ESC>
  222.     Functions available are:                                            <ESC>
  223.                                                                         <ESC>
  224.     - Display directory                                                 <ESC>
  225.     - Display translation of key                                        <ESC>
  226.     - Display/update control keys                                       <ESC>
  227.     - Clear current key definitions                                     <ESC>
  228.                                                                         <ESC>
  229.      These functions are are very useful for looking up key definitions <ESC>
  230. and control keys without interrupting your current program.  They are   <ESC>
  231. not available in the Newkeysm.exe program saving 11K in memory.         <ESC>
  232.                                                                         <ESC>
  233.      Press CTRL \ and play around, but be careful not to clear memory.  <ESC>
  234.                                                                         <ESC>
  235.      Press F9 to continue, ALT H for help.                              <ESC>
  236. <enddef>
  237. *
  238. <begdef><F9><esc>cls<enter>
  239.                  OTHER NEWKEY FEATURES                                  <ESC>
  240.                 Demonstration for <altn>                           <ESC>
  241.                                                                         <ESC>
  242.                                                                         <ESC>
  243.      In addition to the features already demonstrated Newkey provides   <ESC>
  244. several other features including:                                       <ESC>
  245.                                                                         <ESC>
  246.    - Time delays during playback                                        <ESC>
  247.    - Extension of keys supported beyond the normal IBM set              <ESC>
  248.    - Support of different key definitions for synonym keys              <ESC>
  249.    - Error correction during key definition                             <ESC>
  250.    - Recursion detection during key definition and playback             <ESC>
  251.    - Ability to change the dynamic define area size at Newkey loading   <ESC>
  252.    - Macro may call itself                                              <ESC>
  253.    - Slow typing mode                                                   <ESC>
  254.    - Cancel Newkey processing during playback or definition             <ESC>
  255.                                                                         <ESC>
  256.      For a demonstration of Newkeysp, the NEWKEY Support Program,       <ESC>
  257. Press CTRL F1.  Press ALT H for help                                    <ESC>
  258. <enddef>
  259. *
  260. <begdef><ctrlF1><esc>cls<enter>
  261.                NEWKEYSP, THE NEWKEY SUPPORT PROGRAM                     <ESC>
  262.                   Demonstration for <altn>                           <ESC>
  263.                                                                         <ESC>
  264.                                                                         <ESC>
  265.      Newkeysp provides many features to complement Newkey, including:   <ESC>
  266.                                                                         <ESC>
  267.    - Display key directory                                              <ESC>
  268.    - Display key translations                                           <ESC>
  269.    - Save key definition file from memory to disk                       <ESC>
  270.    - Load key definition file to memory from disk                       <ESC>
  271.    - Merge key definition file into memory from disk                    <ESC>
  272.    - Clear current key definitions from memory                          <ESC>
  273.    - Toggle Newkey on/off                                               <ESC>
  274.    - Display/update Newkey control keys                                 <ESC>
  275.    - Display/update Newkey parameters                                   <ESC>
  276.    - Unload and reclaim memory (DOS 1.1 only)                           <ESC>
  277.    - Execute macros from batch files                                    <ESC>
  278.    - Turn slow typing mode on/off                                       <ESC>
  279.                                                                         <ESC>
  280.                                                                         <ESC>
  281.      Press CTRL F2 to continue, ALT H for help.                         <ESC>
  282.                                                                         <ESC>
  283. <enddef>
  284. *
  285. <begdef><ctrlF2><esc>cls<enter>
  286.                     INVOKING NEWKEYSP                                   <ESC>
  287.                 Demonstration for <altn>                            <ESC>
  288.  
  289.                                                                         <ESC>
  290. Newkeysp's functions may be invoked in one of two ways:                 <ESC>
  291.                                                                         <ESC>
  292.    1.  Type Newkeysp, press enter and a menu of options will be         <ESC>
  293. displayed.                                                              <ESC>
  294.                                                                         <ESC>
  295.    2.  Type Newkeysp plus a parameter and Newkeysp will perform the     <ESC>
  296. requested function and return to DOS.  This option is particularly      <ESC>
  297. useful in a batch file invoked at system initialization.                <ESC>
  298.                                                                         <ESC>
  299.    The best way to familiarize yourself with Newkeysp's functions is    <ESC>
  300. to call it up and try out the various menu options.                      <ESC>
  301.                                                                         <ESC>
  302.                                                                         <ESC>
  303.      Press CTRL F3 to continue, ALT H for help.                         <ESC>
  304. <enddef>
  305. *
  306. <begdef><ctrlF3><esc>cls<enter>
  307.                          END OF TOUR                                    <ESC>
  308.                                                                         <ESC>
  309.     Well <altn>, this ends the Newkey tour.  We hope that you  <ESC>
  310. find Newkey a powerful new tool which will enhance your productivity    <ESC>
  311. and make life with your PC a lot easier.                                <ESC>
  312.                                                                         <ESC>
  313.     If you do find Newkey a useful addition to your software tools,     <ESC>
  314. we encourage you to place your order as soon as possible.  As a         <ESC>
  315. registered user you will receive                                        <ESC>
  316.                                                                         <ESC>
  317.    - a copy of the latest version of Newkey                             <ESC>
  318.    - a printed manual (50+ pages, tips on use, index)                   <ESC>
  319.    - notification of new versions                                       <ESC>
  320.                                                                         <ESC>
  321.  To order send a check for $19.95 along with your name and address to   <ESC> 
  322.                                                                         <ESC>
  323.                      FAB Software                                       <ESC>
  324.                      P.O. Box 336                                       <ESC>
  325.                      Wayland, MA 01778                                  <ESC>
  326.                                                                         <ESC>
  327.     If not completely satisfied, return Newkey within 30 days for       <ESC>
  328. a full refund.  You may use the convenient order form enclosed in the   <ESC>
  329. documentation you printed off before beginning this tour.               <ESC>
  330.                                                                         <ESC>
  331.      Press CTRL F4 to exit tour, ALT H for help                         <ESC>
  332. <enddef>
  333. <begdef><ctrlF4><esc>cls<enter>
  334.                        EXIT TOUR                                        <ESC>
  335.                 Demonstration for <altn>                            <ESC>
  336.                                                                         <ESC>
  337.     Since this tour does not run under a program, the simplest way to   <ESC>
  338. exit is to just continue on your way and do what you want.  Since       <ESC>
  339. several function keys and others have been redefined, you will probably <ESC>
  340. want to return to their native meanings.  This may be done in two ways: <ESC>
  341.                                                                         <ESC>
  342.   - Press CTRL 6.  This will deactivate Newkey completely.              <ESC>
  343.                                                                         <ESC>
  344.   - Press ALT C.  This will invoke Newkeysp to clear the current key    <ESC>
  345.     definitions from memory leaving Newkey active, but with all key     <ESC>
  346.     definitions completely purged.                                      <ESC>
  347.                                                                         <ESC>
  348.     To reclaim the memory Newkey has reserved you can re-boot by        <ESC>
  349. pressing ALT-CTRL-DEL simultaneously.                                   <ESC>
  350.                                                                         <ESC>
  351.     To retake portions of the tour just press the appropriate           <ESC>
  352. function key.  Press ALT D for a tour directory.                        <ESC>
  353.                                                                         <ESC>
  354.      Press ALT H for help.                                              <ESC>
  355. <enddef>
  356. *
  357. <begdef><alth><esc>cls<enter>
  358.                         HELP                                            <ESC>
  359.                                                                         <ESC>
  360.     You are currently taking a guided tour of Newkey.  This tour does   <ESC>
  361. not know where you just came from so you will have to choose from one   <ESC>
  362. of the options below to continue.                                       <ESC>
  363.                                                                         <ESC>
  364.                                                                         <ESC>
  365. EXIT TOUR - Press CTRL F3.                                              <ESC>
  366.                                                                         <ESC>
  367. LOST - If you get lost the tour may be restarted at any point by        <ESC>
  368. pressing the appropriate function key.  Press ALT D for a directory     <ESC>
  369. listing of function keys.                                               <ESC>
  370.                                                                         <ESC>
  371. ORDERING INFORMATION - Press CTRL F3.                                   <ESC>
  372.                                                                         <ESC>
  373. TOUR GUIDE - Press ALT D for a tour directory.                          <ESC>
  374.                                                                         <ESC>
  375. <enddef>
  376. <begdef><altd><esc>cls<enter>
  377.                         TOUR DIRECTORY                                  <ESC>
  378.                                                                         <ESC>
  379. ALT  F1 - Begin tour                                                    <ESC>
  380.                                                                         <ESC>
  381.      F1 - Introduction                                                  <ESC>
  382.      F2 - Defining a key definition (macro)                             <ESC>
  383.      F3 - Nested key definitions                                        <ESC>
  384.      F4 - Variable length fill-in-the-blanks fields                     <ESC>
  385.      F5 - Fixed length fill-in-the-blanks fields                        <ESC>
  386.      F6 - Switching Newkey on/off                                       <ESC>
  387.      F7 - Translation bypass (escape)                                   <ESC>
  388.      F8 - Dynamic display/update features                               <ESC>
  389.      F9 - Other features                                                <ESC>
  390.                                                                         <ESC>
  391. CTRL F1 - Introduction to Newkeysp, the Newkey support program          <ESC>
  392. CTRL F2 - Invoking Newkeysp                                             <ESC>
  393. CTRL F3 - Registration information                                      <ESC>
  394. CTRL F4 - Exit tour                                                     <ESC>
  395.                                                                         <ESC>
  396. ALT C   - Clear this demonstration from Newkey's memory                 <ESC>
  397. ALT D   - This screen                                                   <ESC>
  398. ALT H   - Help                                                          <ESC>
  399.                                                                         <ESC>
  400.     Press any of the above keys to continue tour.                       <ESC>
  401. <enddef>
  402. *
  403. <begdef><altc>NEWKEYSP /C<enter><enddef>
  404. *
  405. <begdef>&HELLO <altn><enddef>
  406. *
  407. <begdef><alt1>Enter any number of keystrokes followed by enter: 
  408. <vfld>...<vfld> <esc>and Newkey will finish for you.<enddef>
  409. *
  410. <begdef><alt2>Enter 2 keystrokes: <ffld>..<ffld> and Newkey will fini
  411. sh for you.<enddef>
  412. *
  413. <begdef><alt3>Enter '<notr>&' followed by enter: <vfld>...<vfld>  Yo
  414. u will notice<esc>
  415. that '<notr>&' has been redefined to 'HELLO'.<esc>
  416. Now enter ctrl-2 and '<notr>&' followed by enter:
  417.  <vfld>...<vfld><esc>
  418. You will notice that '<notr>&' was returned, not 'HELLO'.<esc>
  419. This is an example of Newkey's no translation feature.<esc>
  420.                                                                         <ESC>
  421.      Press F8 to continue.                                              <ESC>
  422. <enddef>
  423. *
  424.  
  425.